home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr11 / paf2cap1.zip / PAF2CAP.DOC < prev    next >
Text File  |  1995-02-28  |  6KB  |  113 lines
  1.               PAF2CAP - Convert PAF Ahnentafel Report to a CSV File
  2.                                  Copyright 1995
  3.                            Version 1.0 - February 28, 1995
  4.                                 By Mike St. Clair
  5.  
  6.     PAF2CAP  will convert a PAF Ahnentafel report, that has been written to a
  7.     disk  file, into  a  standard  format  called  CSV.  CSV stands for Comma
  8.     Separated  Values.  The  program  was  written  to produce the input file 
  9.     required  by  another  freeware  program  called  CAP_GEN  that  produces 
  10.     circular pedigree charts on PostScript printers.
  11.  
  12.     PAF2CAP is Freeware.  This means you are not required to pay  any license
  13.     fee to make  legal use of it but the  author  retains  ownership  and the
  14.     copyright.   PAF2CAP  can be  freely  distributed as long as no charge is
  15.     required  in excess of the cost of distribution.  This file (PAF2CAP.DOC)
  16.     must be included with any copy of the program.
  17.  
  18.     There  is no warranty that PAF2CAP performs any useful function.  Still I
  19.     would be  delighted to  hear if you liked it or if it has been useful, to
  20.     accept reports of problems and to receive suggestions for possible future
  21.     enhancements.  I  wrote this program as a byproduct of the maintenance of
  22.     my  electronic  newsletter,  PAF  Review.   After  hearing  from  several 
  23.     individuals who were looking for a way to create circular pedigree charts
  24.     from  their  PAF  data,  I started searching for such a utility.  I found
  25.     one  called  CAPS_GEN that  would  almost  do the job.  It was created by 
  26.     Rafal  Prinke  of  Poland.  CAP_GEN  reads one of the standard Ahnentafel 
  27.     output  formats  from  Brothers  Keeper  and produces a circular pedigree 
  28.     chart  on  a PostScript Printer.  Rafal also included the ability to read
  29.     standard  CSV  files  so  those  not using Brothers Keeper would have the
  30.     possibility of using his program.
  31.  
  32.     PAF  will  produce  an  Ahnentafel  report,  but  not  in the same format
  33.     as  Brothers  Keeper.  This utility will read PAF's Ahnentafel report and 
  34.     create the required CSV file. CAPS_GEN only uses the first 6 generations,
  35.     or  Ahnentafel  numbers  through 63, but my  utility will convert all the
  36.     generations found in it's input file.  The higher numbers will be ignored
  37.     by  CAPS_GEN  so they cause no problem if present.  On the other hand, if 
  38.     you  want  to use the resulting CSV file as input to another program such 
  39.     as WordPerfect or Excel you will have the entire report.
  40.  
  41.     To  convert  a  file,  issue  the  command  "PAF2CAP filename".  When you 
  42.     print  a  file  to disk from PAF, the default file name will be PRINT.DAT 
  43.     but  you  are  allowed  to  specify  whatever  filename  you prefer.  The 
  44.     converted  file  will  have a similar name but the file extension will be 
  45.     TXT.  For  example,  if  you use PAF's default you would use PRINT.DAT as 
  46.     the  input  filename and PAF2CAP would create a new file named PRINT.TXT.
  47.     If  you  attempt  to  convert  a  file with a name ending with ".TXT" the 
  48.     program will fail.  Even though it is normal to name "CSV" files with the
  49.     extension ".CSV", I followed the convention expected by CAPS_GEN instead.
  50.  
  51.     Version History:
  52.  
  53.     Version 1 was released February 28, 1995
  54.  
  55.       This was the initial release of PAF2CAP
  56.     PAF2CAP Version 1.0               28 February 1995                 Page 2
  57.  
  58.     *************************************************************************
  59.     *          Following is an excerpt from a PAF Ahnentafel Chart          *
  60.     *************************************************************************
  61.                                 AHNENTAFEL CHART
  62.  
  63.     21 Feb 1995                                                        Page 1
  64.     ═════════════════════════════════════════════════════════════════════════
  65.                            1st GENERATION
  66.  
  67.         1 Noah McKenzie "Mike" ST. CLAIR Jr.-1: b 12 Jun 1949 Boise,
  68.           Ada,Idaho
  69.     ─────────────────────────────────────────────────────────────────────────
  70.                            2nd GENERATION
  71.  
  72.        2 Noah McKenzie ST. CLAIR-9: b 9 Mar 1912 Blue Eye,,Missouri; m 7 Oct
  73.          1946 Nampa,Canyon,Idaho; d 8 Aug 1987 San Bernadino,San Bernadino,
  74.          California
  75.        3 Geneva STEEL-10: b 9 Dec 1914 Cardston,Lethbridge,Alberta; d 29
  76.          Dec 1990 Redlands,San Bernadino,California
  77.     ─────────────────────────────────────────────────────────────────────────
  78.                            3rd GENERATION
  79.  
  80.        4 James Alvis ST. CLAIR-20: b 30 Nov 1872 Walnut Shade,Taney,Missouri;
  81.          m 1 Apr 1900 ,Taney,Missouri; d 5 Jul 1952 Monett,Lawrence,Missouri
  82.        5 Lillian Lucettie EVANS-21: b 9 Sep 1881 Tuscumbia,Miller,Missouri; d
  83.          25 Jun 1963 Monett,Lawrence,Missouri
  84.        6 Oswald Alexander STEEL-17: b 8 Aug 1881 Thorndale,Middlesex,
  85.          Ontario; m 28 Jun 1907 ,,Alberta,Canada; d 8 Jan 1918 Aetna,
  86.          Lethbridge,Alberta
  87.        7 Mary Leota HANSEN-18: b 30 Jan 1892 Aetna,,Alberta,Canada; d Dec
  88.          1985 Redlands,San Bernadino,California
  89.  
  90.     *************************************************************************
  91.     *         Following is the format of the file created by PAF2CAP        *
  92.     *************************************************************************
  93.     1,"Noah McKenzie "Mike" ST. CLAIR Jr.","12 Jun 1949",""
  94.     2,"Noah McKenzie ST. CLAIR","9 Mar 1912","8 Aug 1987"
  95.     3,"Geneva STEEL","9 Dec 1914","29 Dec 1990"
  96.     4,"James Alvis ST. CLAIR","30 Nov 1872","5 Jul 1952"
  97.     5,"Lillian Lucettie EVANS","9 Sep 1881","25 Jun 1963"
  98.     6,"Oswald Alexander STEEL","8 Aug 1881","8 Jan 1918"
  99.     7,"Mary Leota HANSEN","30 Jan 1892","Dec 1985"
  100.  
  101.     You can reach me to report success or  problems, or make suggestions via:
  102.  
  103.          CompuServe:      71522,3314
  104.          Internet:        st-clair@genealogy.emcee.com
  105.          GEnie:           M.ST.CLAIR2
  106.  
  107.     Also as Mike Stclair on most genealogy BBS conferences.
  108.  
  109.     Or by U.S. Mail as:
  110.          Mike St. Clair
  111.          327 North 800 East
  112.          American Fork, Utah  84003
  113.